docs(skills): sweep objectstack-ai SKILL.md to the ask/build two-agent model (ADR-0063/0064)#2194
Merged
Merged
Conversation
…t model (ADR-0063/0064) Finishes the prose sweep that #2168 closed on prematurely, and lands the two #2165 doc items that had no home in the skill-authoring contract: - Rewrite the "Built-in Unified Assistant (ADR-0040)" section to the two surface-bound agents (`ask` OSS/free, `build` cloud/paid). `data_chat` / `metadata_assistant` now appear ONLY in the alias-table note, never as vocabulary. - Document the `surface: 'ask' | 'build' | 'both'` skill field, the built-in skills' affinities, and that an agent's tools = the union of its surface-compatible skills' tools (no global fall-through; affinity is a load error). - Document that `surface:'build'` skills are inert on OSS — intentional tiering, not a bug — and that a build-intent turn degrades gracefully. - Reconcile the stale "0040 unified assistant" row in adr/PRIORITIZATION.md (tool-scoping shipped via #2181; only the blueprint scale gate remains). Generated skill docs unchanged (generator reads frontmatter only). Refs #2165 #2168 Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
|
The latest updates on your projects. Learn more about Vercel for GitHub.
|
github-actions
Bot
added
documentation
This was referenced Jun 22, 2026
xuyushun441-sys
added
the
skip-changeset
xuyushun441-sys
added a commit
that referenced
this pull request
Jun 22, 2026
…ADR-0063/0064) (#2206) Follow-up to #2194 — sweeps the remaining docs-site + ADR prose that still described the superseded ADR-0040 unified-assistant / custom-agent model: - guides/ai-capabilities.mdx: reframe the "AI Agents" section to the two surface-bound platform agents (`ask` OSS/free, `build` cloud/paid). State ADR-0063 §2 (you extend via skills, not agents — `*.agent.ts` is platform-internal, `allowRuntimeCreate:false`) and ADR-0064 (tools = union of surface-compatible skills' tools; `surface:'build'` inert on OSS). Add the `surface` field to the AgentSchema table; recontextualize the example `defineAgent()` blocks as anatomy, not a tenant-authoring tutorial. - guides/plugin-chatbot-integration.mdx: code examples use `ask`, not the legacy `data_chat` alias. - adr/0040: add a Superseded-by-ADR-0063 banner + Status line (body kept as the historical record). Generated schema refs (references/ai/agent.mdx, skill.mdx) already carry the `surface` field — build-docs.ts reruns with no diff. Docs-only. Refs #2168 Co-authored-by: Jack Zhuang <277994282+os-zhuang@users.noreply.github.com> Co-authored-by: Claude Opus 4.8 <noreply@anthropic.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Finishes the documentation tail of ADR-0063 / ADR-0064. The code split landed in #2181 (+ cloud#417), but the third-party skill-authoring contract —
skills/objectstack-ai/SKILL.md— was never swept and still described the old ADR-0040 unifieddata_chatassistant model. This closes that gap and lands the two #2165 doc items that had no home.What changed
skills/objectstack-ai/SKILL.md— replaced the### Built-in Unified Assistant (ADR-0040)section with### Built-in agents: \ask` & `build` (ADR-0063 / ADR-0064)`:ask(data product, OSS/free) andbuild(authoring product, cloud/paid). No per-turn intent classifier.data_chat/metadata_assistantnow appear only in the alias-table note, never as vocabulary (per ADR-0063 follow-up: collapse data-chat naming drift + skill→shell affinity + tier-aware routing #2165).surface: 'ask' | 'build' | 'both'skill field, the built-in skills' affinities (table), and that an agent's tools = the union of its surface-compatible skills' tools (no global fall-through; affinity is a load error — ADR-0064).surface:'build'skills are inert on OSS — intentional tiering, not a bug, and that a build-intent turn degrades gracefully (ADR-0063 follow-up: collapse data-chat naming drift + skill→shell affinity + tier-aware routing #2165 item 8 / tier-aware routing).docs/adr/PRIORITIZATION.md— reconciled the stale0040 unified assistantgap row (tool-scoping shipped via feat(ai): split ask/build agents by surface + tool scoping (ADR-0063/0064) #2181; only the blueprint scale gate remains; 0063/0064 supersede 0040).Verification
build-skill-docs.ts) reruns with no diff — it reads frontmatter only, which is untouched, so the body rewrite is safe.data_chat/metadata_assistantoccurrences are inside the alias-table note (verified by grep).Issue hygiene (separate, see comments)
Refs #2165 #2168
🤖 Generated with Claude Code